home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3n / t_free.z / t_free
Encoding:
Text File  |  2002-10-03  |  6.8 KB  |  133 lines
  1.  
  2.  
  3.  
  4. tttt____ffffrrrreeeeeeee((((3333NNNN))))                                                          tttt____ffffrrrreeeeeeee((((3333NNNN))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _tttt______ffff_rrrr_eeee_eeee - free a library structure
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_ffff_dddd_eeee_ffff ______XXXX_OOOO_PPPP_EEEE_NNNN______SSSS_OOOO_UUUU_RRRR_CCCC_EEEE
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_xxxx_tttt_iiii_...._hhhh_>>>>
  14.      _####_eeee_llll_ssss_eeee
  15.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_tttt_iiii_uuuu_ssss_eeee_rrrr_...._hhhh_>>>>
  16.      _####_eeee_nnnn_dddd_iiii_ffff
  17.  
  18.      _iiii_nnnn_tttt _tttt______ffff_rrrr_eeee_eeee_((((_pppp_tttt_rrrr_,,,, _ssss_tttt_rrrr_uuuu_cccc_tttt______tttt_yyyy_pppp_eeee_))))
  19.      _cccc_hhhh_aaaa_rrrr _****_pppp_tttt_rrrr_;;;;
  20.      _iiii_nnnn_tttt _ssss_tttt_rrrr_uuuu_cccc_tttt______tttt_yyyy_pppp_eeee_;;;;
  21.  
  22. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  23.      The _tttt______ffff_rrrr_eeee_eeee function frees memory previously allocated by _tttt______aaaa_llll_llll_oooo_cccc.  This
  24.      function will free memory for the specified structure, and will also free
  25.      memory for buffers referenced by the structure.
  26.  
  27.      _pppp_tttt_rrrr points to one of the six structure types described for _tttt______aaaa_llll_llll_oooo_cccc, and
  28.      _ssss_tttt_rrrr_uuuu_cccc_tttt______tttt_yyyy_pppp_eeee identifies the type of that structure, which can be one of
  29.      the following:
  30.  
  31.      _TTTT______BBBB_IIII_NNNN_DDDD           _ssss_tttt_rrrr_uuuu_cccc_tttt _tttt______bbbb_iiii_nnnn_dddd
  32.  
  33.      _TTTT______CCCC_AAAA_LLLL_LLLL           _ssss_tttt_rrrr_uuuu_cccc_tttt _tttt______cccc_aaaa_llll_llll
  34.  
  35.      _TTTT______OOOO_PPPP_TTTT_MMMM_GGGG_MMMM_TTTT        _ssss_tttt_rrrr_uuuu_cccc_tttt _tttt______oooo_pppp_tttt_mmmm_gggg_mmmm_tttt
  36.  
  37.      _TTTT______DDDD_IIII_SSSS            _ssss_tttt_rrrr_uuuu_cccc_tttt _tttt______dddd_iiii_ssss_cccc_oooo_nnnn
  38.  
  39.      _TTTT______UUUU_NNNN_IIII_TTTT_DDDD_AAAA_TTTT_AAAA       _ssss_tttt_rrrr_uuuu_cccc_tttt _tttt______uuuu_nnnn_iiii_tttt_dddd_aaaa_tttt_aaaa
  40.  
  41.      _TTTT______UUUU_DDDD_EEEE_RRRR_RRRR_OOOO_RRRR        _ssss_tttt_rrrr_uuuu_cccc_tttt _tttt______uuuu_dddd_eeee_rrrr_rrrr
  42.  
  43.      _TTTT______IIII_NNNN_FFFF_OOOO           _ssss_tttt_rrrr_uuuu_cccc_tttt _tttt______iiii_nnnn_ffff_oooo
  44.  
  45.      where each of these structures is used as an argument to one or more
  46.      transport functions.
  47.  
  48.      _tttt______ffff_rrrr_eeee_eeee will check the _aaaa_dddd_dddd_rrrr, _oooo_pppp_tttt, and _uuuu_dddd_aaaa_tttt_aaaa fields of the given structure
  49.      (as appropriate), and free the buffers pointed to by the _bbbb_uuuu_ffff field of the
  50.      _nnnn_eeee_tttt_bbbb_uuuu_ffff [see _iiii_nnnn_tttt_rrrr_oooo(3N)] structure.  If _bbbb_uuuu_ffff is _NNNN_UUUU_LLLL_LLLL, _tttt______ffff_rrrr_eeee_eeee will not
  51.      attempt to free memory.  After all buffers are freed, _tttt______ffff_rrrr_eeee_eeee will free
  52.      the memory associated with the structure pointed to by _pppp_tttt_rrrr.
  53.  
  54.      Undefined results will occur if _pppp_tttt_rrrr or any of the _bbbb_uuuu_ffff pointers points to
  55.      a block of memory that was not previously allocated by _tttt______aaaa_llll_llll_oooo_cccc.
  56.  
  57.      This function resides within both the X/Open compliant _llll_iiii_bbbb_xxxx_nnnn_eeee_tttt and the
  58.      SVR4 compliant _llll_iiii_bbbb_nnnn_ssss_llll Network Services libraries.  Network Services
  59.      applications which require X/Open compliance must link-load with _----_llll_xxxx_nnnn_eeee_tttt.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. tttt____ffffrrrreeeeeeee((((3333NNNN))))                                                          tttt____ffffrrrreeeeeeee((((3333NNNN))))
  71.  
  72.  
  73.  
  74.      Network Services applications which require SVR4 compliance must link-
  75.      load with _----_llll_nnnn_ssss_llll.
  76.  
  77.      On failure, _tttt______eeee_rrrr_rrrr_nnnn_oooo may be set to the following:
  78.  
  79.      _TTTT_SSSS_YYYY_SSSS_EEEE_RRRR_RRRR        A system error has occurred during execution of this
  80.                     function.
  81.  
  82.      _TTTT_NNNN_OOOO_SSSS_TTTT_RRRR_UUUU_CCCC_TTTT_YYYY_PPPP_EEEE   If ______XXXX_OOOO_PPPP_EEEE_NNNN______SSSS_OOOO_UUUU_RRRR_CCCC_EEEE is defined, then this _tttt______eeee_rrrr_rrrr_nnnn_oooo value is
  83.                     returned when an unsupported _ssss_tttt_rrrr_uuuu_cccc_tttt______tttt_yyyy_pppp_eeee is requested.
  84.  
  85. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  86.      _iiii_nnnn_tttt_rrrr_oooo(3N), _tttt______aaaa_llll_llll_oooo_cccc(3N)
  87.  
  88. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  89.      _tttt______ffff_rrrr_eeee_eeee returns 0 on success and -1 on failure and _tttt______eeee_rrrr_rrrr_nnnn_oooo is set to
  90.      indicate the error.
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.